package tech.heptagram.staff.service;

import java.util.List;

import tech.heptagram.staff.model.Department;
import tech.heptagram.staff.query.DepartmentQuery;
import tech.heptagram.staff.query.DepartmentRemoveReq;
import tech.heptagram.staff.query.DepartmentReq;

/**
 * @author wang.yuchuan
 * @date 2018/9/10
 */
public interface DepartmentService {

    /**
     * 根据员工部门ID获取部门信息
     *
     * @param id 部门ID
     * @return 部门信息
     */
    Department getById(Integer id);

    /**
     * 根据条件查询部门信息
     *
     * @param departmentQuery 查询条件
     * @return 部门列表
     */
    List<Department> findByQuery(DepartmentQuery departmentQuery);

    /**
     * 根据员工部门IDs获取部门信息
     *
     * @param ids 部门id列表
     * @return 部门信息列表
     */
    List<Department> findByIds(List<Integer> ids);

    /**
     * 获取指定员工的部门列表
     *
     * @param staffCode
     * @return
     */
    List<Department> findByStaffCode(String staffCode);

    /**
     * 依据 钉钉部门id 获取部门
     * @param dingDepartmentId 钉钉部门id
     * @return 部门信息
     */
    Department findByDingDepartmentId(Long dingDepartmentId);

    /**
     * 添加新部门
     * @param departmentReq 部门信息
     * @return 部门ID
     */
    Integer save(DepartmentReq departmentReq);

    /**
     * 修改部门信息
     * @param departmentReq 接受参数
     */
    void update(DepartmentReq departmentReq);

    /**
     * 删除部门信息
     * @param departmentReq 接收参数
     */
    void delete(DepartmentRemoveReq departmentReq);

    /**
     * 根据父部门ID查询
     * @param parentId 父部门ID
     * @return 部门列表信息
     */
    List<Department> getByParentId(Integer parentId);
}
